Repository navigation
fix(release): resolve v2.4.0 qualification regressions and reconcile release notes - #9190
Conversation
a395d5e to
7950a0e
Compare
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google · self_reported
Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
说明:本次能力包中
reviewer_execution为unavailable(session_not_bound),因此依据契约按self_reported署名发布;此外依据仓库本地优先策略(wait_for_ci=false),未等待或轮询远程 GitHub Actions CI。
动机 / Motivation
受本次改动影响的调用方与维护者包括:运行流式对话脱敏与解析的 Chat 服务及用户、使用 generic-cli (loopx_turn_host_request_v1) 且未配置独立校验器的外置 Turn 宿主、托管运行或直接触发 LarkGoalTopicRuntimeService 轮询与关闭生命周期的飞书运行时、构建或测试 dsh-loopx-plugin 影子观察器的插件集成方、并行执行 pytest 套件的验证者,以及核对 v2.4.0 发布说明的维护者。
在基线 origin/main 上,#9080 放宽了共享路径正则尾部匹配后导致 Chat 流式回答会把行内代码裸根路径示例(如 Windows 盘符根路径字面量)误脱敏为 [local-path],同时 dsh-loopx-plugin 镜像未同步该可选尾部而破坏契约校验;generic-cli 的两处调用点对 validation_command_json 判断不一致引发预备/节律失配;直接非托管调用 LarkGoalTopicRuntimeService._poll_profile 退出时会触发 refresh() 泄漏后台守护线程与消费者锁文件;test_registry_git_probe 在高并发分片负载下因 1.5s 超时前未写入子进程 PID 而偶发失败。PR #9190 逐一修复上述问题并对齐 docs/product/releases/v2.4.0.md,但在 LarkGoalTopicRuntimeService.close() 中新增了对 _startup_thread 的 join(timeout=3),反而引入了新的关闭阻塞回归。
在精确 head 上,Chat 行内代码根路径保真、generic-cli 校验器门控一致性、dsh-loopx-plugin 镜像正则对齐、_poll_profile 非托管调用防泄漏、test_registry_git_probe 超时余量以及 v2.4.0 发布说明对账均已落地并经本地验证通过;但 LarkGoalTopicRuntimeService.close() 会因等待阻塞的 _startup_thread 最多卡顿 3 秒,导致 tests/test_chat_startup_isolation.py 中 2 项启动/关闭隔离测试确定性失败。
本 PR 不放宽 public_safe_text.py 对外部公开产物的严格路径拒止边界,不改变 codex-cli 默认起始身份绑定规则,不将生产环境 Git 探针默认 1.5s 超时放大到 4.0s,也不把 v2.4.0 文档对齐当成完整发布资格回执或直接触发合并/发版。
改动思路 / Approach
PR #9190 针对 v2.4.0 发布前质量门禁暴露的 5 个具体回归以及发布说明缺口采取逐点定点收敛策略,整体职责分层清晰:
各修复均保持在既有边界内:loopx/chat.py 仅将展示脱敏正则收窄为必须含子路径的 _CHAT_LOCAL_PATH_SURFACE_PATTERN 而不弱化 public_safe_text 守卫;turn_cadence.uses_effect_bound_start_identity 统一收敛 turn.py 与 turn_run_once.py 的 validation_command_json 判定;observer.ts 保留独立插件包所需的镜像正则校验合约;唯独 LarkGoalTopicRuntimeService.close() 误把可阻塞外部文件系统读的 _startup_thread 纳入同步 join 列表。
当前 PR 边界限定在修复这 5 项 v2.4.0 资格验证回归及同步 docs/product/releases/v2.4.0.md 至最新主干,不扩张为公共安全引擎重构或异步启动架构重写;仅需撤销 close() 对 _startup_thread 的阻塞等待即可使全量边界收口。
- 展示脱敏与公开安全守卫解耦:
#9080为对齐扩展展示层守卫而在loopx/public_safe_text.py中允许 Unix 与 Windows 盘符无尾部裸根前缀匹配,意外让共用同一正则的loopx/chat.py把文档或回答中的行内代码裸根示例改写成[local-path]。本 PR 在loopx/chat.py引入专用的_CHAT_LOCAL_PATH_SURFACE_PATTERN(要求根路径后必须跟随非空子路径段),保留public_safe_text.LOCAL_PATH_SURFACE_PATTERN的严格 fail-closed 边界不变。 - 统一
generic-cli起始身份与校验器门控:此前turn.py在行内单独判断validation_command_json,而turn_cadence.uses_effect_bound_start_identity与turn_run_once.py未带入该条件,导致无独立校验器的generic-cli(loopx_turn_host_request_v1)在未做租约准备时仍按effect_id绑定节律请求 ID,使源状态变化后的重跑错误续借旧预留而非触发interval_wait。本 PR 将validation_command_json收敛进单一决策函数uses_effect_bound_start_identity。 - Lark 监听器非托管退出与清理加固:
LarkGoalTopicRuntimeService._poll_profile新增managed_worker判定,避免直接调用在finally分支误触发self.refresh()启动游离的loopx-lark-*守护线程;新增_retiring_workers、_stop_consumer_process与按构造时HOME定锚的_consumer_lease_dir(),防止替换下来的消费者管道或进程泄漏真实主目录锁文件;但同时在close()中错误加入了startup_thread.join(timeout=3)。 - DSH 插件镜像同步与测试隔离:同步
packages/dsh-loopx-plugin/src/observer.ts的LOCAL_PATH_SURFACES可选尾部正则以对齐public_safe_text.py,并在test_registry_git_probe.py单独放宽分片并发下 fake git 启动写 PID 的超时余量至4.0s。 - 发布说明对齐:将合入主干的
#9056、#9063、#9070、#9187、#9188、#9189以及本 PR#9190同步至docs/product/releases/v2.4.0.md的中英文分组与贡献者致谢。
具体改动 / Changes
对照规范 docs/product/release-readiness.md(基线提交 3d15059fef142138a60fc8a03c8394e92879387c)逐项核对准入标准:
RR-DOC-SMOKE(implemented):docs/product/releases/v2.4.0.md覆盖最新主干提交范围内的全部 PR 与贡献者归属,通过release-readiness-doc-smoke.py全部 13 个--surface校验及中英摘要对账。RR-COMPAT-BOUNDARY(implemented):loopx/chat.py保留 Chat 展示可用性的同时未放松public_safe_text.py;turn_cadence.py/turn.py/turn_run_once.py恢复无校验器generic-cli与含校验器 v1 适配器的契约边界;packages/dsh-loopx-plugin/src/observer.ts与规范正则逐字对齐。RR-CANARY-ISOLATION(not_met):LarkGoalTopicRuntimeService.close()阻塞等待_startup_thread最长 3 秒,违背非阻塞关闭隔离契约,导致tests/test_chat_startup_isolation.py2 项既有测试确定性失败。
关键代码讲解
_CHAT_LOCAL_PATH_SURFACE_PATTERN(loopx/chat.py:59)
在 Chat 展示脱敏模块中定义了要求根前缀后必须跟随[^\s'"<>]+的正则,替换_local_path_pattern与redact_local_paths末段兜底处对LOCAL_PATH_SURFACE_PATTERN的直接引用。输入不含子路径的裸根示例(Unix 主目录裸根或 Windows 盘符裸根行内代码)时不再被替换为[local-path];一旦带有真实子路径或命中protected_paths保护根,仍按原逻辑脱敏为[local-path]或[project]/./...,而public_safe_text.py` 及扩展展示守卫保持原严格判定不变。uses_effect_bound_start_identity(loopx/cli_commands/turn_cadence.py:25)
新增可选参数validation_command_json: str | None = None,仅当host == "codex-cli"或host == "generic-cli"且同时满足adapter_request_schema == COMPLETE_TURN_HOST_REQUEST_SCHEMA与bool(validation_command_json)时返回True。loopx/cli_commands/turn.py:106移除原有内联条件改由统一函数判定,loopx/cli_commands/turn_run_once.py:871同步传入validation_command_json,从而保证租约自动准备与节律request_id绑定在两处调用点完全一致。LarkGoalTopicRuntimeService._poll_profile与_consumer_lease_dir(loopx/extensions/lark/goal_topic_runtime_service.py:502,607)
_poll_profile入口在self._lock下校验worker is not None and worker[0] is stop并记为managed_worker,finally分支仅在managed_worker and not self._closed.is_set()时执行self.refresh(),阻断非托管直调退出后隐式派生新后台线程的泄漏路径;同时_retiring_workers追踪被替换的在途工作线程,_consumer_lease_dir()在Path.home未被测试 monkeypatch 替换时固定使用构造期捕获的self._default_home,避免测试恢复环境变量后把锁文件写入真实宿主目录。LarkGoalTopicRuntimeService.close(loopx/extensions/lark/goal_topic_runtime_service.py:1023— 存在阻塞性缺陷)
close()正确增加了_refresh_retry.cancel()、_retiring_workers清理与_stop_consumer_process(consumer)终止消费者子进程逻辑,但它同时将startup_thread = self._startup_thread加入threads并执行thread.join(timeout=3)。当snapshot_provider()或队列文件读取阻塞时,该join(timeout=3)会令close()与上层ChatHTTPServer.shutdown()同步阻塞,触发下文 P1 回归。LOCAL_PATH_SURFACES(packages/dsh-loopx-plugin/src/observer.ts:73)
将 Unix 根路径、Windows 盘符路径与家目录简写模式尾部补齐为可选组(?:[^\s'"<>]+)?,与loopx/public_safe_text.py的LOCAL_PATH_SURFACE_PATTERN和HOME_RELATIVE_PATH_PATTERN恢复逐arm等价;经test_typescript_mirror_equals_the_canonical_local_path_surfaces与observer.spec.ts双端验证,含裸 Unix 根或裸盘符根的SUMMARY_TOKEN` 均被 fail-closed 拦截。
对主干的风险 / Risks
[P1 阻塞缺陷] LarkGoalTopicRuntimeService.close() 阻塞等待 _startup_thread,破坏非阻塞关闭隔离契约
- Problem & Trigger:当
LarkGoalTopicRuntimeService.start()已启动后台发现线程self._startup_thread(name="loopx-lark-startup",daemon=True)且snapshot_provider()或_resume_session_queues()中的文件 I/O 阻塞(例如系统等待目录访问授权或慢盘读取)时,调用service.close()或ChatHTTPServer.shutdown()(serve_chat退出路径)。 - Code Path:
loopx/extensions/lark/goal_topic_runtime_service.py:1032-1052(LarkGoalTopicRuntimeService.close())。 - Observed Outcome & Evidence:PR
#9190将startup_thread = self._startup_thread放进threads列表并在关闭路径上执行startup_thread.join(timeout=3),导致close()被阻塞最长 3 秒。我在精确 head7950a0e278d03318ee74b70bb35190ad1ef805f6上运行tests/test_chat_startup_isolation.py时,5 项测试中有 2 项确定性失败(FAIL):test_real_chat_entrypoint_serves_while_binding_discovery_is_blocked(worker.join(2)后worker.is_alive()仍为True)与test_close_does_not_wait_for_real_queue_file_read(closed.wait(1)超时返回False)。对照基线origin/main(3d15059fef)同一测试集 5/5 全量通过(耗时7.17s)。 - Impact:违背
goal_topic_runtime_service.py:929已明确声明的“文件系统读可长于服务关闭生命周期”的架构边界,会使桌面端/Chat 服务在目录权限弹窗或慢 I/O 挂起时无法快速优雅退出。 - Minimum Repair:从
LarkGoalTopicRuntimeService.close()的threads等待列表中移除startup_thread,保留self._closed.set()、self._refresh_retry.cancel()、_stop_consumer_process以及对工作线程与_retiring_workers的join。我已在隔离临时覆盖中验证该单处最小修复:同时运行tests/test_chat_startup_isolation.py与tests/extensions/test_lark_realtime_dispatch.py全部24 passed in 11.05s(PASS)。 - Rerun Command:
uv run --extra test python -m pytest -q tests/test_chat_startup_isolation.py tests/extensions/test_lark_realtime_dispatch.py
其余边界、隔离与权限检查
- Scope Fit & Active Callers:
loopx/chat.py的_CHAT_LOCAL_PATH_SURFACE_PATTERN服务于redact_local_paths、redact_response_markdown、VisibleResponseStreamFilter等全部 Chat 展示链路;uses_effect_bound_start_identity由turn.py与turn_run_once.py两个唯一生产入口共用;observer.ts通过packages/dsh-loopx-plugin宿主插件注册并在tests/capabilities/test_reliability_diagnostics_dsh_provider.py中与规范文件受控对齐。 - Default-Off Isolation:
dsh-loopx-plugin影子观察器仍保持export const inject: readonly string[] = []且仅在明确注入目标上下文时激活;generic-cli的首回合自动租约准备严格限制在显式声明--host-adapter-request-schema loopx_turn_host_request_v1且携带非空--validation-command-json时启用。在真实 CLIturn run-once对照试验中,未传--validation-command-json的无租约hard_lease待办以拒绝退出(exit=1,lease_active=False),传入校验器后则自动完成声明并提交(exit=0,status="committed",quota_spent=True)。 - Authority & Typed Rules:无新增越权生命周期或字符串黑名单分类;
tests/test_registry_git_probe.py:185仅在单条超时测试中通过monkeypatch将超时窗口调为4.0s,生产默认_GIT_PROBE_TIMEOUT_SECONDS = 1.5与管道排空隔离测试均未放宽。
语义与 CI 对齐
本 PR 不新增或篡改公共状态词表(复用既有 public_safe_text.LOCAL_PATH_SURFACE_PATTERN、COMPLETE_TURN_HOST_REQUEST_SCHEMA 与 docs/product/release-readiness.md 发布面结构,semantic_alignment 判定为 aligned / reuse_existing)。基于 wait_for_ci=false 契约未查询远程 CI,所有关键验证均已在精确 head 本地隔离执行:pytest 针对性回归 391 passed、Turn 驱动与 Lark 运行时 314 passed(49 skipped 仅因未设置独立 core wheel 环境变量 LOOPX_CORE_TEST_PYTHON)、架构与 Chat/Lark 伴随套件 1957 passed / 2 failed(失败全数位于 tests/test_chat_startup_isolation.py,单独重跑 2 failed, 3 passed vs 基线 5/5 passed)、Lark 关联服务测试 187 passed、Turn 准备与隔离回归 278 passed、dsh-loopx-plugin (typecheck + vitest) 372 passed、release-readiness-doc-smoke.py(全 13 个 surface)PASS、ruff / mypy(17 个严格文件)/ check_rfc_bilingual.py / loopx check / canary premerge(19 项检查全绿)PASS。
我的整体评价 / Verdict
综合评估 outcome_impact:long_horizon 为 regression,user_experience 为 regression。尽管 PR #9190 准确修复了原本阻塞 v2.4.0 发布验证的 5 个问题(Chat 行内根路径保真、generic-cli 校验器门控同步、非托管 _poll_profile 防派生线程、DSH 插件镜像正则对齐、分片并发下的 git 探针测试稳定性)并完成了 docs/product/releases/v2.4.0.md 至最新主干的对账,但 LarkGoalTopicRuntimeService.close() 新增的 startup_thread.join(timeout=3) 引入了违反既有关闭隔离契约的 P1 阻塞回归,使真实 Chat 入口在目录发现挂起时无法在要求时间内完成关闭。
- 视觉检查说明:经检查改动路径(
loopx/chat.py、loopx/cli_commands/turn*.py、loopx/extensions/lark/goal_topic_runtime_service.py、packages/dsh-loopx-plugin/src/observer.ts、docs/product/releases/v2.4.0.md与对应测试文件),本 PR 不涉及任何已渲染的前端页面、Desktop 界面或交互组件布局变更,视觉审查不适用。(unverified_scope:none)。 - 代码体量与简化:整体改动
+163/-52(12 个文件)比例合理、高度聚焦;turn_cadence.uses_effect_bound_start_identity已消除原有双处条件漂移,移除close()中多余的startup_thread等待即可保持最小清晰边界。 - 词表归属:复用既有词表与规范契约(
reuse_existing),无需新增 RFC 或词表注册项。 - 精确 Head 新鲜度与复审门槛:本结论严格基于精确 head
7950a0e278d03318ee74b70bb35190ad1ef805f6。移除LarkGoalTopicRuntimeService.close()对startup_thread的join并确认tests/test_chat_startup_isolation.py与tests/extensions/test_lark_realtime_dispatch.py同步通过后,即可在下一精确 head 复审通过。
English verdict: REQUEST_CHANGES at exact head 7950a0e due to a P1 regression in LarkGoalTopicRuntimeService.close() joining _startup_thread and blocking shutdown isolation (tests/test_chat_startup_isolation.py 2 failed, 3 passed vs 5/5 passed on origin/main); the other 5 regression fixes, release-notes reconciliation, dsh-loopx-plugin checks, and canary premerge pass.
…release notes Signed-off-by: LoopX Agent <[email protected]>
7950a0e to
38e5b89
Compare
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google · self_reported
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
说明:本次
loopx pr-review能力包返回reviewer_execution: unavailable(session_not_bound),按评审契约使用self_reported署名发布;同时按目标仓库本地优先策略(wait_for_ci: false),本次审查基于精确 head 本地验证结论,未等待或轮询远程 GitHub Actions CI。
动机 / Motivation
受本次改动影响的调用方与运维者包括:执行流式回答展示脱敏的 Chat 服务与用户、使用完整 v1 协议但未配置校验命令的 generic-cli 外部 Turn 宿主、直接调用或托管运行 LarkGoalTopicRuntimeService 生命周期的飞书运行时、打包或测试 dsh-loopx-plugin 影子观察器的插件集成方、在并行分片下执行测试套件的验证者,以及核对 v2.4.0 发布说明的维护者。
在主干基线 871cc36 上,#9080 为收紧公开边界允许裸根前缀匹配,却连带导致共用同一正则的 loopx/chat.py 把回答里的行内代码裸根示例误脱敏为 [local-path],同时 dsh-loopx-plugin 镜像未同步该规则而违背跨语言一致性测试;#9047 在 turn.py 与 turn_run_once.py 对 generic-cli 是否传入 validation_command_json 判定不一致,令未配校验器的宿主在中断重入时误复用同一 effect_id 预留而非退回 interval_wait;非托管直调 LarkGoalTopicRuntimeService._poll_profile 退出时触发 refresh() 泄漏后台线程及锁文件;并行高负载下 test_registry_git_probe 超时测试偶发未写完子进程 PID 即被终止。上一审查提交 7950a0e 虽已修复上述 5 项问题,却因在 close() 中同步等待 _startup_thread 导致 tests/test_chat_startup_isolation.py 两项隔离测试失败;在当前精确 head 38e5b89 中已撤销该阻塞等待并补全 #9191 的 v2.4.0 发布说明对账。
若保持主干现状不做修复,v2.4.0 发布资格门禁中的 Lark 线程/锁隔离、Turn 启动恢复、Chat 流式代码渲染以及 DSH 镜像契约校验均无法同时收口,并在真实运行时留下线程泄漏与预备逻辑分叉风险。当前精确 head 38e5b89 已在全部 6 个修复面上落地并通过本地实测验证:Chat 展示脱敏保留行内裸根示例而不放松 public_safe_text.py 严格公开拦截;turn_cadence.uses_effect_bound_start_identity 统一收敛双调用点的 validation_command_json 门控;LarkGoalTopicRuntimeService 既防止非托管直调派生后台线程与默认主目录锁泄漏,又在 close() 期间严格保持对 _startup_thread 的非阻塞隔离;packages/dsh-loopx-plugin 与规范正则逐项一致并拦截裸根 SUMMARY_TOKEN;test_registry_git_probe 超时测试仅调整单测自身超时余量;docs/product/releases/v2.4.0.md 通过全部 13 个可选能力面的文档烟测。
本 PR 不放宽 loopx/public_safe_text.py 对对外公开产物或结构化回执的严格路径拦截边界,不更改 codex-cli 的起始身份绑定策略,不调高生产环境 Git 探针默认 1.5s 超时阈值,不重构异步启动线程架构,也不将发布说明对齐当成完整发布资格签收或直接合并发版。
改动思路 / Approach
各修复均收敛在既有职责边界内:loopx/chat.py 仅分离展示脱敏正则 _CHAT_LOCAL_PATH_SURFACE_PATTERN 而不削弱 public_safe_text.py 公开边界守卫;turn_cadence.uses_effect_bound_start_identity 消除 turn.py 与 turn_run_once.py 之间的双处条件漂移;goal_topic_runtime_service.py 通过 managed_worker、_retiring_workers、_stop_consumer_process 与 _consumer_lease_dir 隔离非托管调用和在途线程回收,同时避免 close() 同步 join _startup_thread;observer.ts 保持独立 npm 包所需的镜像合约对齐,test_registry_git_probe.py 仅调高单测自身超时余量。
当前 PR 边界严格限定在修复 v2.4.0 发布前门禁暴露的 5 项回归并同步 docs/product/releases/v2.4.0.md 至最新主干 871cc36(含 #9191),不扩展为公共安全规则引擎重写、Lark 启动模型重构或直接发版操作。
从数据流与控制流看,本次变更分别沿着四条独立边界修复“职责错配”或“双处分叉”,未引入新的全局状态或平行权威:
上一次审查 head 7950a0e278
└─ LarkGoalTopicRuntimeService.close()
├─ join(workers + retiring_workers)
└─ join(_startup_thread, timeout=3) ──▶ FAIL: 慢盘/阻塞发现时卡住关闭流程
当前精确 head 38e5b89c70cf028c5854af0ef3706ae63f43fc37(示意图,来源:goal_topic_runtime_service.py)
└─ LarkGoalTopicRuntimeService.close()
├─ _closed.set() + _refresh_retry.cancel() + _stop_consumer_process(consumers)
├─ join(workers + retiring_workers,跳过 current_thread) ──▶ PASS: 正常退出且无游离消费者
└─ 不等待 _startup_thread ──▶ PASS: 满足“文件发现 I/O 可长于关闭周期”的隔离边界
- 展示层脱敏与公开安全守卫解耦:
loopx/public_safe_text.py的LOCAL_PATH_SURFACE_PATTERN继续由validate_public_safe_value、public_safe_compact_text、classify_private_text等公开导出安全门禁独占使用,对任何裸根前缀保持 fail-closed 拦截;面向终端用户回答渲染的loopx/chat.py则改用要求根路径后必须带非空子路径段的_CHAT_LOCAL_PATH_SURFACE_PATTERN,避免技术问答中行内代码的裸盘符或裸根目录前缀被误替换为[local-path]。 - 统一
generic-cli起始身份门控:turn_cadence.uses_effect_bound_start_identity增加可选参数validation_command_json,作为turn.py(首回合租约准备)与turn_run_once.py(节律预留request_id选择)的单一决策函数,彻底消除此前一处校验器存在性判断在两处调用点不同步的问题。 - Lark 非托管轮询防泄漏与非阻塞关闭:
_poll_profile仅在入口锁内确认自身属于当前self._workers[profile]时标记managed_worker=True,退出时非托管调用不再触发self.refresh();_refresh_profile_workers替换旧 worker 时将存活旧线程收入_retiring_workers并终止关联消费者子进程;_consumer_lease_dir()在Path.home未被测试 monkeypatch 替换时固定使用构造期捕获的self._default_home,阻断夹具清理后写入真实宿主目录锁文件的竞态;close()则严格只回收已知工作线程与在途线程、取消重试定时器并终止消费者,不再阻塞等待_startup_thread。 - DSH 插件镜像正则同步、测试超时余量与发布说明对齐:
packages/dsh-loopx-plugin/src/observer.ts补齐可选尾部以对齐public_safe_text.py并在observer.spec.ts覆盖裸根拒绝;tests/test_registry_git_probe.py仅在单条超时的假 git 进程树测试里通过monkeypatch放宽超时窗口至4.0s;docs/product/releases/v2.4.0.md同步#9056、#9063、#9070、#9187、#9188、#9189、#9191及#9190本身修复条目与@cocolord/@maxliux5归属。
具体改动 / Changes
对照规范 docs/product/release-readiness.md(已提交基准修订 5422e6d67aacce70ec1e312164da07744b5abcf0)逐项核对验收标准:
RR-DOC-SMOKE(implemented):docs/product/releases/v2.4.0.md将主干新合入 PR(#9056、#9063、#9070、#9187、#9188、#9189、#9191)及#9190同步至 EN/ZH Highlights、Capabilities & Workflows、Quality & Testing 及 Community Contributors,通过examples/release/release-readiness-doc-smoke.py全部 13 个--surface校验且无新增或遗漏可选能力入口。RR-COMPAT-BOUNDARY(implemented):loopx/chat.py仅调整展示脱敏正则而保持loopx/public_safe_text.pyfail-closed 边界不变;loopx/cli_commands/turn_cadence.py、turn.py、turn_run_once.py统一generic-cli校验器存在性门控;packages/dsh-loopx-plugin/src/observer.ts与规范正则逐字等价并通过test_typescript_mirror_equals_the_canonical_local_path_surfaces及observer.spec.ts;tests/test_registry_git_probe.py不改变生产超时默认值1.5s。RR-CANARY-ISOLATION(implemented):loopx/extensions/lark/goal_topic_runtime_service.py在38e5b89c70已移除上一版7950a0e278在close()中对_startup_thread的同步等待,同时保留非托管_poll_profile防派生、_retiring_workers追踪、_stop_consumer_process进程清理与_consumer_lease_dir()隔离;tests/test_chat_startup_isolation.py与tests/extensions/test_lark_realtime_dispatch.py共 24 项全部通过。
关键代码讲解
_CHAT_LOCAL_PATH_SURFACE_PATTERN(loopx/chat.py:59)
在 Chat 展示脱敏模块内独立定义仅匹配“包含非空子路径尾段”的本地路径正则,替换_local_path_pattern与redact_local_paths兜底分支中对public_safe_text.LOCAL_PATH_SURFACE_PATTERN的直接引用。当protected_paths为空或指向自定义项目目录时,行内裸盘符与裸根目录前缀保留原文可读性,而真实带子路径的绝对路径及受保护项目根仍稳定脱敏为[local-path]、[project]或./...;与此同时,public_safe_text.find_public_safe_local_path与classify_private_text仍保持裸根拦截不变。uses_effect_bound_start_identity(loopx/cli_commands/turn_cadence.py:25)
签名扩展为(host, adapter_request_schema, validation_command_json=None):当host == "codex-cli"时返回True;当host == "generic-cli"时要求同时满足adapter_request_schema == COMPLETE_TURN_HOST_REQUEST_SCHEMA且bool(validation_command_json)。loopx/cli_commands/turn.py:106移除原有额外内联条件并改由该函数统一判定,loopx/cli_commands/turn_run_once.py:871同步透传validation_command_json,确保无独立校验器的generic-cli在首回合不触发租约自动准备,且中断重入时按turn_key重新接受间隔门禁校验。LarkGoalTopicRuntimeService._poll_profile与_consumer_lease_dir(loopx/extensions/lark/goal_topic_runtime_service.py:607,502)
_poll_profile入口加锁比对worker is not None and worker[0] is stop得到managed_worker,仅在受管 worker 且未关闭时才允许finally路径触发self.refresh(),阻断直接单元测试退出后隐式拉起后台loopx-lark-*线程的路径;_consumer_lease_dir()检查Path.home.__func__是否属于标准库pathlib,未打补丁时回落到构造期捕获的self._default_home,防止测试撤销monkeypatch后并发残余读取将锁文件写入宿主家目录。LarkGoalTopicRuntimeService.close与_refresh_profile_workers(loopx/extensions/lark/goal_topic_runtime_service.py:1023,955)
_refresh_profile_workers淘汰旧 worker 时若线程仍存活则加入self._retiring_workers并对匹配stop的消费者调用_stop_consumer_process;close()在锁内取消_refresh_retry定时器、清空_workers与_retiring_workers、置位所有stop并终止消费者进程,随后仅join(timeout=3)活跃工作线程与在途淘汰线程(并过滤current_thread防自锁)。与7950a0e278相比,本精确 head 彻底移除了对_startup_thread的join,保证当目录权限确认或队列文件 I/O 阻塞时close()与ChatHTTPServer.shutdown()仍能立即返回。LOCAL_PATH_SURFACES(packages/dsh-loopx-plugin/src/observer.ts:73)
将 Unix 绝对根目录、Windows 盘符根以及家目录简写(tilde prefix)三条正则的尾段改为(?:[^\s'"<>]+)?,恢复与loopx/public_safe_text.py中LOCAL_PATH_SURFACE_PATTERN和HOME_RELATIVE_PATH_PATTERN的逐臂文本等价,并由packages/dsh-loopx-plugin/tests/observer.spec.ts新增两条裸根SUMMARY_TOKEN` 拒止断言提供双端防护。
对主干的风险 / Risks
经对精确 head 38e5b89c70cf028c5854af0ef3706ae63f43fc37 完整基线到当前提交(871cc36348..38e5b89c70)及所有受影响共享边界的逐一复核,未发现阻塞主干合入的缺陷(no blocking findings)。较上一版 7950a0e278 暴露的 LarkGoalTopicRuntimeService.close() 等待 _startup_thread 回归(曾导致 tests/test_chat_startup_isolation.py 2 项失败)已在当前提交彻底移除并经实测恢复全绿。
- 残余风险与边界说明:
uses_effect_bound_start_identity对validation_command_json采用字符串真值检查(bool(validation_command_json)),若调用方显式传入"[]"仍会在turn.py走入admit_preparation,随即被prepare_turn_host_arguments下游解析或command_validation._normalize_argv空列表校验 fail-closed 拒绝而不会创建错误租约或调用宿主;这与修复前turn.py原内联逻辑完全一致,非本 PR 引入的新风险。tests/test_core_distribution.py中 49 项独立 Core wheel 用例因未设置LOOPX_CORE_TEST_PYTHON而跳过(1 passed, 49 skipped),独立 wheel 打包验证需按发布流程另行执行;另docs/product/releases/v2.4.0.md的 13 项--surface文档校验已通过,完整版本 tag/桌面端包及真机验证仍归属独立发布门禁。
- Active Callers & Scope Fit:
_CHAT_LOCAL_PATH_SURFACE_PATTERN直接服务于redact_local_paths、redact_response_markdown与VisibleResponseStreamFilter等全部 Chat 展示脱敏调用链;uses_effect_bound_start_identity由仅有的两处 Turn 启动入口turn.py与turn_run_once.py共用;LarkGoalTopicRuntimeService直接承担 Chat 服务内的飞书事件监听与私聊投递生命周期;observer.ts通过packages/dsh-loopx-plugin的./observer导出挂载并在跨语言契约测试中被校验。 - Default-Off Isolation:
dsh-loopx-plugin影子观察器维持export const inject: readonly string[] = [],未改变默认停用隔离边界;generic-cli起始身份绑定继续严格限定在显式传入--host-adapter-request-schema loopx_turn_host_request_v1且携带非空--validation-command-json的调用路径上。在隔离sqlitehard_lease对照实测中,不带--validation-command-json的generic-cli调用以LoopX Turn route is not host executable(state_written=None,host_invoked=None)退出,不会触发意外租约准备;带上校验器后则如期执行租约准备并进入宿主调度(state_written=True,host_invoked=True)。 - Authority & Typed Rules:无新增越权生命周期或字符串黑名单规则;
tests/test_registry_git_probe.py:185仅通过monkeypatch放宽单条超时测试的进程树准备窗口,生产常量_GIT_PROBE_TIMEOUT_SECONDS = 1.5与管道排空隔离测试保持不变。 - 本地验证汇总(精确 head
38e5b89c70cf028c5854af0ef3706ae63f43fc37,wait_for_ci: false):pytest -q tests/test_chat_startup_isolation.py tests/extensions/test_lark_realtime_dispatch.py: PASS (24 passed in 11.01s)pytest -q tests/test_chat_path_redaction.py tests/test_registry_git_probe.py tests/capabilities/test_reliability_diagnostics_dsh_provider.py: PASS (105 passed in 7.59s)pytest -q tests/test_chat_response_parsing.py: PASS (48 passed in 0.54s)pytest -q tests/control_plane/test_public_safety_path_shapes.py tests/control_plane/test_public_safe_local_path_owner.py tests/control_plane/test_public_safe_text_classifier.py tests/extensions/test_lark_goal_topic_runtime.py: PASS (279 passed in 38.78s)pytest -q -n auto tests/test_loopx_turn_driver.py: PASS (212 passed in 37.82s;其中-k "uses_effect_bound_start_identity or managed_start_interruption"单独复核13 passed)pytest -q tests/test_core_distribution.py: PASS(边界说明:1 passed, 49 skipped,因未设置LOOPX_CORE_TEST_PYTHON)pnpm --dir packages/dsh-loopx-plugin run typecheck && pnpm --dir packages/dsh-loopx-plugin test: PASS (15 test files, 372 passed in 65.25s)python examples/release/release-readiness-doc-smoke.py --release-notes docs/product/releases/v2.4.0.md(全部 13 个--surface项): PASSruff check(全部改动 Python 文件)、python -m mypy(17 个严格内核文件)、scripts/check_rfc_bilingual.py、loopx check --scan-path ...(12 个改动文件公开边界扫描): PASSloopx canary premerge --from-git-diff --git-diff-base origin/main: PASS(6direct checks、10catalog canaries、8risk-profile smokes 含dsh-loopx-plugin-validation.py全三阶段quality/package/runtime、1public-boundary 全部通过,failures=0)
我的整体评价 / Verdict
综合评估 outcome_impact:long_horizon 为 improved,user_experience 为 improved。PR #9190 在精确 head 38e5b89c70cf028c5854af0ef3706ae63f43fc37 上彻底消除了上一提交 7950a0e278 误引入的 Lark 关闭阻塞回归,精准解决了 v2.4.0 发布前验证暴露的 5 项回归并完成了 docs/product/releases/v2.4.0.md 与主干最新合入项的对账,全部本地回归套件与 canary premerge 门禁均已通过。
- 视觉检查说明:经核对本次改动涉及的全部文件路径(docs/product/releases/v2.4.0.md、loopx/chat.py、loopx/cli_commands/turn*.py、loopx/extensions/lark/goal_topic_runtime_service.py、packages/dsh-loopx-plugin/src/observer.ts 及相关测试),本 PR 不涉及任何已渲染前端界面、Desktop 视图或交互组件布局变更,视觉审查不适用。(
unverified_scope:none) - 代码体量与简化:全量差异为 12 个文件
+161/-52,每一处改动均直接对应具体故障根因。turn_cadence.uses_effect_bound_start_identity已消除原有双处判定分叉,展示脱敏与公开边界校验、DSH 镜像校验与 Lark 托管/非托管生命周期均维持了当前最小清晰边界,评估结论为proportionate/retain。 - 词表与语义对齐:
semantic_alignment判定为aligned(reuse_existing),继续复用既有public_safe_text.LOCAL_PATH_SURFACE_PATTERN、COMPLETE_TURN_HOST_REQUEST_SCHEMA与docs/product/release-readiness.md发布面契约,未新增、分叉或弱化任何公共状态词表,无需补充 RFC 或词表注册修复。 - 精确 Head 新鲜度:本批准结论绑定当前远程精确 head
38e5b89c70cf028c5854af0ef3706ae63f43fc37(wait_for_ci: false,独立于远程 CI 队列;实际合并仍需由拥有仓库合并权限的维护者执行)。
English verdict: APPROVE at exact head 38e5b89; the blocking _startup_thread join in LarkGoalTopicRuntimeService.close() from 7950a0e is removed, all 5 v2.4.0 qualification regressions and release-note reconciliations pass local validation (including test_chat_startup_isolation.py + test_lark_realtime_dispatch.py 24 passed, test_chat_path_redaction + test_registry_git_probe + dsh_provider 105 passed, test_loopx_turn_driver 212 passed, dsh-loopx-plugin typecheck/vitest 372 passed, release-readiness-doc-smoke 13 surfaces, and canary premerge 19/19 checks).
Delivery Brief
v2.4.0release qualification on23dacd5f, and reconciledocs/product/releases/v2.4.0.mdup toorigin/main(3d15059fef).loopx/chat.py,tests/test_chat_path_redaction.py): Separate_CHAT_LOCAL_PATH_SURFACE_PATTERN(requiring a non-empty tail after Windows drive/home/Unix roots) so bare inline-code examples like`C:\`are preserved in streamed chat answers without narrowingloopx/public_safe_text.pyfail-closed guards.generic-clivalidation_command_jsonlease auto-prep (loopx/cli_commands/turn_cadence.py,turn.py,turn_run_once.py,tests/test_loopx_turn_driver.py): Passvalidation_command_jsonintouses_effect_bound_start_identity(...)at both call sites (turn.pyandturn_run_once.py) so complete v1 adapters without a configured validator no longer trigger premature lease auto-prep errors._poll_profilebackground thread / lease cleanup (loopx/extensions/lark/goal_topic_runtime_service.py,tests/extensions/test_lark_realtime_dispatch.py): Ensure unmanaged direct_poll_profilecalls do not leave activeloopx-lark-mewbackground worker threads or session lock files behind after completion/close.packages/dsh-loopx-plugin/src/observer.ts,tests/observer.spec.ts): SyncLOCAL_PATH_SURFACESoptional-tail patterns with canonicalloopx/public_safe_text.pyand cover bare-rootSUMMARY_TOKENrejection inobserver.spec.ts.tests/test_registry_git_probe.py): Givetest_registry_git_probe_retires_the_process_tree_on_timeouta4.0ssubprocess probe budget so/bin/shreliably writesgrandchild.pidbefore timeout retirement under parallel shard contention.docs/product/releases/v2.4.0.md): Reconcile newly mergedmainPRs (#9056,#9063,#9070,#9187,#9188,#9189) across EN & ZH sections.v2.4.0release notes (docs/product/releases/v2.4.0.md). Zero private paths or local state included.pytest(targeted 9-file suite covering chat redaction, public safety, DSH observer mirror parity, Lark dispatch, git probe):368 passedpytest(test_loopx_turn_driver.py,test_core_distribution.py,test_lark_goal_topic_runtime.py):314 passed, 49 skippedpnpm --dir packages/dsh-loopx-plugin test(build+typecheck+ vitest):372 passed (15 test files)python examples/release/release-readiness-doc-smoke.py --release-notes docs/product/releases/v2.4.0.md(all 13 surfaces): PASSruff check,mypy(17files),check_rfc_bilingual.py,control-plane-maintainability-ratchet-smoke.py,loopx check --scan-path ...: PASS (0errors)